home *** CD-ROM | disk | FTP | other *** search
/ Technotools / Technotools (Chestnut CD-ROM)(1993).ISO / lang_c / mscheap2 / heap.inf < prev    next >
Text File  |  1990-03-14  |  4KB  |  101 lines

  1.  
  2.  
  3.                Introduction to the Replacement Heap Manager
  4.                --------------------------------------------
  5.  
  6.  
  7.     The enclosed software is a library of heap management routines
  8.     compatible with MSC 5.1.  It consists of the basic heap manager,
  9.     the extended capability package, which provides user programs with
  10.     control over the behavior of the heap, and the heap debugging package,
  11.     which adds error checking routines to the basic heap operations.
  12.  
  13.     The file HEAPDC.COM contains the heap documentation files.  It includes
  14.     both the reference manual and the background technical information.  The
  15.     file HEAPLB.EXE contains the libraries, header files, and demonstration
  16.     source files.  Both of these files are self-extracting archives.
  17.  
  18.     The replacement heap library manages the heap in such a way as to
  19.     limit the fragmentation of the heap, and, with the global free list,
  20.     optimize the speed of heap operations.  It also offers the following
  21.     benefits:
  22.  
  23.         - automatic recovery of space wasted in the default data segment
  24.  
  25.         - rational handling of zero-length entries and NULL pointers
  26.  
  27.         - precise control over the interface with the DOS memory manager
  28.  
  29.         - consistent treatment of "far" and "huge" heap entries
  30.  
  31.         - superior performance, reliability, and memory efficiency
  32.  
  33.  
  34.     The extended capabilities of the replacement heap manager include:
  35.  
  36.         - relocation of heap entries for garbage collection and heap
  37.           compaction
  38.  
  39.         - shrinking the heap, and releasing excess memory back to DOS
  40.           to maximize the space for spawned programs
  41.  
  42.         - user control over the behavior of the heap manager offers
  43.           LIFO, first-fit, and best-fit algorithms
  44.  
  45.         - detailed reports on the state of the heap for analysis of
  46.           heap usage and behavior
  47.  
  48.         - extended versions of standard functions for "huge" heap entries
  49.  
  50.         - direct access to the heap control data structures
  51.  
  52.         - heap manager accepts non-DOS memory as a resource
  53.  
  54.  
  55.     The replacement heap manager is less vulnerable to corruption than
  56.     the original.  It also provides the following tools for identifying
  57.     heap-related problems:
  58.  
  59.         - distinctive heap pointers reduce possibility of heap corruption
  60.  
  61.         - user controlled safety margins on every allocation
  62.  
  63.         - detailed consistency checks, including heap-control-block
  64.           reciprocity and safety margin integrity
  65.  
  66.         - read-only heap entries may be monitored for unanticipated changes
  67.  
  68.         - debugging versions of heap functions check heap integrity
  69.           and report errors.
  70.  
  71.         - tracing versions of heap functions report heap transactions
  72.           including parameters and return values.
  73.  
  74.  
  75.     Further information is available in the file HEAPINFO.TXT which
  76.     contains a detailed description of the operation of the replacement
  77.     heap manager, and the file HEAP.MAN which contains a reference manual
  78.     for the heap management functions.
  79.  
  80.     
  81.     FAIR WARNING:  This version of the heap manager has no known bugs, and
  82.                    and passes a battery of tests designed to exercise it.
  83.                    However, it has not been around very long, so the
  84.                    possibility exists that there are residual bugs still
  85.                    in existence.
  86.  
  87.                    If you find a problem in this package, please contact:
  88.  
  89.                        Lee Winter
  90.                        Optimal Software
  91.                        4 Lacy Lane
  92.                        Nashua, NH 03061-2151
  93.  
  94.                        603-880-9844
  95.  
  96.                        CIS [73710,406]
  97.  
  98.  
  99.  
  100.     
  101.